home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 014 / arce211.arc / ARCE211.DOC < prev   
Encoding:
Text File  |  1987-01-24  |  10.0 KB  |  294 lines
  1.  
  2. ARCE Command                                            Version 2.11
  3. ------------                                            Jan 24, 1987
  4.  
  5.  
  6. Purpose:
  7.         To extract files from an ARC archive file.
  8.  
  9. Format:
  10.  
  11.         ARCE  [d:][path]filename.ext  [filespecs...] [d:outpath]
  12.                                       [/R] [/Q] [/P]
  13.  
  14. Remarks:
  15.  
  16.         The drive and path names are optional.  If omitted, the  current
  17.         drive and path name is used.
  18.  
  19.         The filename must be  supplied.  The extension defaults  to ARC.
  20.         All files matching the supplied filename are processed.  The ARC
  21.         filename may contain the * and ? wildcard characters.
  22.  
  23.         If  no  filespecs  are   supplied,  all  files  are   extracted.
  24.         Otherwise, only those ARC members  which match one of the  up to
  25.         16 filespecs are extracted.
  26.  
  27.         The extracted files  may be placed  on another drive,  and/or in
  28.         another subdirectory by following the optional filespecs with  a
  29.         drive designator and/or path name.
  30.  
  31.         If  the  file  being  extracted  already  exists,  you are asked
  32.         whether or not you want to over-write it.  You may use the |  /R
  33.         option to bypass this prompt.  Use a Y followed by the |  return
  34.         key to over-write the file.
  35.  
  36.         Use the /Q option to suppress alarm sounds, beeps, and bells.
  37.  
  38.         Use  the  /P  option  to  write  the  extracted files to the DOS
  39.         standard output  file.  With  /P, you  may pipe  or redirect the
  40.         output.  An initial line feed  is added to the beginning  of the
  41.         output file.
  42.  
  43.  
  44.  
  45. ARCE Command                                            Version 2.11
  46. ------------                                            Jan 24, 1987
  47.  
  48.  
  49.  
  50.  Examples:
  51.  --------
  52.  
  53.         o  Extract all file from TEST.ARC onto the current drive:
  54.  
  55.               ARCE TEST
  56.  
  57.         o  Extract only file with  an extension of .ASM from the archive
  58.            SOURCE.ARC on drive B and in subdirectory SAVE:
  59.  
  60.               ARCE B:\SAVE\SOURCE *.ASM
  61.  
  62.         o  Extract  all  files  from  all  ARC files in the subdirectory
  63.            called TEST on drive C:
  64.  
  65.               ARCE C:\TEST\*
  66.  
  67.         o  Extract  all  files  from  PROGA.ARC  and  place the files in
  68.            subdirectory OLD on drive B:
  69.  
  70.               ARCE PROGA.ARC B:\OLD
  71.  
  72.         o  Extract all files with an extension of .COM and .EXE from the
  73.            archive PROGS.ARC in directory NEW\WORK on drive B, and place
  74.            the  them  in  subdirectory  SAVE\TEST  on  drive  A; replace
  75.            existing file:
  76.  
  77.               ARCE B:\NEW\WORK\PROGS *.COM *.EXE A:\SAVE\TEST /R
  78.  
  79.         o  Extract  the  file  READ.ME  from  the  archive GIZMO.ARC and
  80.            display it on the console instead of writing it to a file:
  81.  
  82.               ARCE GIZMO READ.ME /P
  83.  
  84.         o  Same as above, except  pass the extracted READ.ME file to the
  85.            LIST file viewer:
  86.  
  87.               ARCE GIZMO READ.ME /P | LIST /S
  88.  
  89.  
  90.  
  91. ARCE Command                                            Version 2.11
  92. ------------                                            Jan 24, 1987
  93.  
  94.  
  95.  
  96.  Error Messages:
  97.  --------------
  98.  
  99.       'filename - premature EOF reading '
  100.  
  101.         Data  is  missing  from  the  archive  file.   The  program   is
  102.         terminated.
  103.  
  104.  
  105.       'filename - unable to set file datestamp'
  106.  
  107.         The file datestamp is set to the current date and time, and  the
  108.         next archive member is processed.
  109.  
  110.  
  111.       'filename - WARNING: file CRC does not match!'
  112.  
  113.         The extracted member  is left on  the output disk,  and the next
  114.         archive member is processed.   The file is probably  invalid but
  115.         is left on the disk for your examination.
  116.  
  117.  
  118.       'Invalid filespec(s)'
  119.  
  120.         The filespec syntax is incorrect.  The filename part may be from
  121.         1  to  eight  characters,  and  may  include the ? or * wildcard
  122.         characters.  The extension may be none to three characters,  and
  123.         may  include  wildcards.   There  is  a  maximum of 16 filespecs
  124.         allowed.  The program terminates.
  125.  
  126.  
  127.       'filename - file already exists. Overwrite it? (y/N) '
  128.  
  129.         The member being extracted already  exists.  If you are using  a
  130.         data  path  utility,  the  file  may  not  actually  be  in  the
  131.         subdirectory be used for output.   Respond with the letter Y  to
  132.         over-write the existing  file, or respond  with the letter  N to
  133.         skip this member and continue to the next.
  134.  
  135.  
  136.       'Abort: Stack overflow'
  137.  
  138.         The member  being extracted  has invalid  data.  The  program is
  139.         terminated.
  140.  
  141.  
  142.       'filename - invalid decode tree count'
  143.  
  144.         The member  being extracted  has invalid  data.  The  program is
  145.         terminated.
  146.  
  147.  
  148.       'filename - new archive format 7 not yet supported'
  149.  
  150.         Format 7 is a special file compression method used internally by
  151.         SEA,  the  authors  of  ARC.  Processing continues with the next
  152.         archive member.
  153.  
  154.  
  155.       'Unable to open archive > arcname'
  156.  
  157.         The  specified  ARC   archive  file  was   not  found,  or   was
  158.         inaccessible.  The program terminates.
  159.  
  160.  
  161.       'CREATE failed > filename'
  162.  
  163.         There was insufficient directory  space, or a failure  accessing
  164.         the output disk.  The program terminates.
  165.  
  166.  
  167.         'Invalid archive format!'
  168.  
  169.         The archive file data is invalid.  The program terminates.
  170.  
  171.  
  172.       'Incorrect DOS version'
  173.  
  174.         Version  2.0  or  later  of  PC  DOS  must be used.  The program
  175.         terminates
  176.  
  177.  
  178.       'Not enough memory.'
  179.  
  180.         A minimum  of 112k  bytes of  memory is  required.  The  program
  181.         terminates.
  182.  
  183.  
  184.       'I/O error reading from arcname'
  185.  
  186.         An incorrectable error occurred attempting to read data from the
  187.         archive file.  The program terminates.
  188.  
  189.  
  190.       'I/O error writing or disk full > filename'
  191.  
  192.         There was not  enough disk space  to write the  complete archive
  193.         member.   The  partially  extracted  file  is  scratched and the
  194.         program terminates.
  195.  
  196.  
  197.       'No matching file(s) found'
  198.  
  199.         No archive files were  found that matched the  supplied filename
  200.         specifications.  The program terminates.
  201.  
  202. ||    'WARNING: Skippig Squashed File!'
  203.  
  204. |       A variant compression method has been used and the file can  not
  205. |       be properly extracted.
  206.  
  207.  
  208.  
  209. ARCE Command                                            Version 2.11
  210. ------------                                            Jan 24, 1987
  211.  
  212.  
  213.  
  214.  Version history:
  215.  ---------------
  216.  
  217.         1.1 - 1/13/86   -initial release
  218.         1.2 - 1/14/86   - correct 'Not enough memory' checking
  219.         1.3 - 1/19/86   - make displays MS-DOS compatible
  220.         1.4 - 1/24/86   - add error messages for new ARC 5.0 formats
  221.         1.5 - 2/24/86   - adds adaptive LZW decompression for code 8
  222.         1.6 - 3/02/86   - adds file selection operands
  223.         1.7 - 3/04/86   - optimizes performance
  224.                         - adds stack checking for munged LZ files
  225.         1.8 - 3/15/86   - modifies CRC computation for more speed
  226.         1.9 - 3/16/85   - minor changes
  227.         1.10 - 3/24/86  - adds wildcards for ARC file name
  228.         1.11 - 3/25/86  - improves UnCrunch performance
  229.         1.12 - 3/28/86  - corrects problem with 0-byte files
  230.                         - adds outspec operand
  231.         1.13 - 4/01/86  - increases stack size for 'crunched' files
  232.                         - correct 'Not enough memory' checking
  233.  
  234.         1.14 - make displays MS-DOS compatible
  235.         1.15 - add error messages for new ARC 5.0 formats
  236.         1.16 - add stack checking for munged LZ files
  237.              - added adaptive LZW deompression for code 8
  238.         1.17 - added file selection
  239.         1.18 - cosmetic changes
  240.  
  241.         1.19, 3/15/86   - improved CRC calculation speed
  242.         1.20, 3/16/85   - changed test for file already exists
  243.         1.21, 3/24/86   - added wildcard for ARC file name
  244.         1.22, 3/25/86   - cosmetic changes
  245.         1.23, 3/28/86   - correct short and empty file problems
  246.         2.00, 04/08/86  - fine tuning of I/O buffering
  247.  
  248.         2.01-2.05, 4-20 thru 9/9/86
  249.                         - improve unsq, correct disk full message
  250.         2.06, 9/17/86   - release from testing
  251.  
  252.         2.07, from 9/19 - not released
  253.         2.08, 12/31/86 - added /P, /Q; fixed /R with redirection
  254.         2.09, 1/5/87   - correct closing of output if /P used; require return
  255.                          (enter key) for over-write prompt
  256.                        - add more validity checking of member headers
  257.         2.10, 1/6/87   - correct use out output file specification
  258.         2.11, 1/24/87  - some cosmetics
  259.  
  260.  
  261.  
  262. ARCE Command                                            Version 2.11
  263. ------------                                            Jan 24, 1987
  264.  
  265.  
  266.  
  267.                         Notice
  268.                         ------
  269.  
  270.         ARCE Copyright  1986 Vernon  D. Buerg,  Wayne Chin.   All rights
  271.         reserved.
  272.  
  273.         ARCE is for use with the IBM  PC using DOS 2.0 or later, and  is
  274.         for personal,  private use  only.  You  may copy  and distribute
  275.         this program freely,  provided that no  fee is charged  for such
  276.         copying  and  distribution,  and  it  is distributed only in its
  277.         original,  unmodified  state.   No  exceptions  will  be granted
  278.         without written permission.
  279.  
  280.                 Vernon D. Buerg
  281.                 456 Lakeshire Drive
  282.                 Daly City, CA  94015
  283.  
  284.                 CompuServe: 70007,1212
  285.                 Data/RBBS:  415-994-2944
  286.                 Fidonet:    125/4
  287.  
  288.         For use by corporations,  institutions, and for profit,  contact
  289.         System Enhancement Associates for licensing information.
  290.  
  291.                    System Enhancement Associates
  292.                    21 New Street, Wayne NJ 07470
  293.  
  294.